home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 1.iso / dist / fw_bind.idb / usr / freeware / catman / u_man / cat1 / dnsquery.Z / dnsquery
Text File  |  2001-04-12  |  4KB  |  102 lines
  1.  
  2. DNSQUERY(@CMD_EXT_U@)             LOCAL         DNSQUERY(@CMD_EXT_U@)
  3.  
  4. NNAAMMEE
  5.      ddnnssqquueerryy -    query domain name servers using    resolver
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ddnnssqquueerryy [--nn _n_a_m_e_s_e_r_v_e_r] [--tt _t_y_p_e]    [--cc _c_l_a_s_s] [--rr _r_e_t_r_y] [--pp _p_e_r_i_o_d] [--dd]
  9.           [--ss] [--vv]    _h_o_s_t
  10.  
  11. DDEESSCCRRIIPPTTIIOONN
  12.      The ddnnssqquueerryy program is a general interface to nameservers    via BIND re
  13.      solver library calls.  The    program    supports queries to the    nameserver
  14.      with an opcode of QUERY.  This program is intended    to be a    replacement or
  15.      supplement    to programs like nstest, nsquery and nslookup.    All arguments
  16.      except for    _h_o_s_t and _n_a_m_e_s_e_r_v_e_r are    treated    without    case-sensitivity.
  17.  
  18. OOPPTTIIOONNSS
  19.      --nn    _n_a_m_e_s_e_r_v_e_r
  20.          The nameserver    to be used in the query.  Nameservers can ap
  21.          pear as either    Internet addresses of the form _w_._x_._y_._z or can
  22.          appear    as domain names.  (Default: as specified in
  23.          _/_e_t_c_/_r_e_s_o_l_v_._c_o_n_f.)
  24.  
  25.      --tt    _t_y_p_e     The type of resource record of    interest.  Types include:
  26.                _A    address
  27.                _N_S    nameserver
  28.                _C_N_A_M_E    canonical name
  29.                _P_T_R    domain name pointer
  30.                _S_O_A    start of authority
  31.                _W_K_S    well-known service
  32.                _H_I_N_F_O    host information
  33.                _M_I_N_F_O    mailbox    information
  34.                _M_X    mail exchange
  35.                _R_P    responsible person
  36.                _M_G    mail group member
  37.                _A_F_S_D_B
  38.                 DCE or AFS server
  39.                _A_N_Y    wildcard
  40.  
  41.          Note that any case may    be used.  (Default: _A_N_Y.)
  42.  
  43.      --cc    _c_l_a_s_s     The class of resource records of interest.  Classes include:
  44.                _I_N    Internet
  45.                _H_S    Hesiod
  46.                _C_H_A_O_S    Chaos
  47.                _A_N_Y    wildcard
  48.  
  49.          Note that any case may    be used.  (Default: _I_N.)
  50.  
  51.      --rr    _r_e_t_r_y     The number of times to    retry if the nameserver    is not re
  52.          sponding.  (Default:  4.)
  53.  
  54.      --pp    _p_e_r_i_o_d     Period    to wait    before timing out.  (Default: RES_TIMEOUT.)
  55.  
  56.      --dd         Turn on debugging.  This sets the RES_DEBUG bit of the    re
  57.          solver's _o_p_t_i_o_n_s field.  (Default:  no    debugging.)
  58.  
  59.      --ss         Use a _s_t_r_e_a_m rather than a packet.  This uses a TCP stream
  60.          connection with the nameserver    rather than a UDP datagram.
  61.          This sets the RES_USEVC bit of    the resolver's _o_p_t_i_o_n_s field.
  62.          (Default:  UDP    datagram.)
  63.  
  64.  
  65.  
  66.      --vv         Synonym for the ``--ss''    flag.
  67.  
  68.      _h_o_s_t     The name of the host (or domain) of interest.
  69.  
  70. FFIILLEESS
  71.      /etc/resolv.conf     to get    the default ns and search lists
  72.      <arpa/nameser.h>
  73.              list of usable    RR types and classes
  74.      <resolv.h>
  75.              list of resolver flags
  76.  
  77. DDIIAAGGNNOOSSTTIICCSS
  78.      If    the resolver fails to answer the query and debugging has not been
  79.      turned on,    ddnnssqquueerryy will simply print a message like:
  80.        Query failed    (rc = 1): Unknown host
  81.  
  82.      The value of the return code is supplied by _h___e_r_r_n_o _.
  83.  
  84. SSEEEE AALLSSOO
  85.      nslookup(@SYS_OPS_EXT@),  nstest(@CMD_EXT@),  nsquery(@CMD_EXT@),
  86.      named(@SYS_OPS_EXT@),  resolver(@FORMAT_EXT@).
  87.  
  88. AAUUTTHHOORR
  89.      Bryan Beecher
  90.  
  91. BBUUGGSS
  92.      Queries of    a class    other than _I_N can have interesting results since ordi
  93.      narily a nameserver only has a list of root nameservers for class _I_N re
  94.      source records.
  95.  
  96.      DDnnssqquueerryy uses a call to iinneett__aaddddrr() to determine if the argument for the
  97.      ``--nn'' option is a    valid Internet address.     Unfortunately,    iinneett__aaddddrr()
  98.      seems to cause a segmentation fault with some (bad) IP addresses (e.g.,
  99.      1.2.3.4.5).
  100.  
  101. 4th Berkeley Distribution    March 10, 1990                     2
  102.